home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)U / (A)U2.ADF / Xoper / Xoper.doc < prev    next >
Text File  |  1989-06-03  |  10KB  |  289 lines
  1.                                  Xoper V1.0
  2.  
  3.                     Copyright (c) Werner Gunther 1988
  4.  
  5. Xoper is a freeware program to display and to control system activity.
  6. Permition is granted to freely distribute this program.
  7.  
  8. --------------------------------------------------------------------------
  9. Changes in V1.2:
  10. New commands: Snoop, Capture, ClrCool, ClrWarm, ClrCold.
  11. Added       : CPU usage by task.
  12.  
  13. Cancel command has been rewritten, some minor bugs removed.
  14. -------------------------------------------------------------------------
  15.  
  16. Starting Xoper from CLI:
  17.  
  18. Xoper [T] [S] [L] [D] [R] [E] [M] [P] [I]
  19.  
  20. These parameters are decribed below. For all those who like long
  21. Startup-Sequences, overcrowded memory and hot-keys enter
  22.  
  23. Xoper -b
  24.  
  25. This will install Xoper in background waiting for LeftAmiga-RightAmiga-X
  26. to pop up. In both cases you don't have to RUN or RUNBACK Xoper, it will
  27. always create its own process.
  28.  
  29. Xoper Commands:
  30. ---------------
  31.  
  32.  Commands can be entered after the prompt '->', these are divided into two
  33. groups:
  34.  
  35. Display commands: These are always single character entries and may be
  36. specified in any order, upper or lower case, with or w/o enbedded blanks,
  37. after the prompt or from CLI as parameters:
  38.  
  39. T = Tasks (Default if Xoper is called without parameters)
  40. Task node (HEX), Display type, status, priority (decimal), CPU usage
  41. (percent), processnumber for Dos-Processes (decimal), taskname.
  42.  
  43. S = Task Signals
  44. Task node (HEX), Allocated Signals (HEX), Signals the Task is waiting for
  45. (HEX), Signals received (HEX), Address of the next instruction to be
  46. executed (HEX).
  47.  
  48. L = Libraries
  49. Base address (HEX), open count (decimal), version (decimal), revision
  50. (decimal), flags (binary), libraryname.
  51.  
  52. D = Devices
  53. Base address (HEX), open count (decimal), version (decimal), revision
  54. (decimal), flags (binary), devicename.
  55.  
  56. R = Resident
  57. Base address (HEX), priority (decimal), flags (binary), version
  58. (decimal), type, name.
  59.  
  60. E = Resources (sorry)
  61. Base address (HEX), open count (decimal), version (decimal), revision
  62. (decimal), flags (binary), resource name.
  63.  
  64. M = Memory
  65. Lower and upper bounds (HEX), bytes free (decimal), attributes, priority
  66. (decimal), hunk name.
  67.  
  68. P = Ports
  69. Node address (HEX), portname, flags, signal bit (decimal), queue length
  70. [number of messages] (decimal), taskname.
  71.  
  72. I = Interrupts
  73. Node address (HEX), pointer to interrupt data (HEX), pointer to interrupt
  74. code (HEX), priority (decimal),type [interupt queue the interrupt belongs
  75. to], interrupt name.
  76.  
  77. H = Help ( or ?)
  78. Show a list of commands.
  79.  
  80. Q = Quit
  81. Same as QUIT (see below).
  82.  
  83. Example: Entering TPM would display Tasks, Ports and Memory. The display
  84. would be updated after a few seconds (5 by default, may be changed
  85. anytime, see below.)
  86.  
  87. Other commands that do not display lists:
  88. These commands may be entered upper or lower case. Parameters enclosed
  89. in '<>' must be, enclosed in '[]' may be specified. Names are usualy
  90. entered as ascii-strings, it can however happen that two or more nodes of
  91. the same name exist. On tasks you may specify the DOS-Processnumber to
  92. sort them out. If everything fails, you can enter the Node-Address with a
  93. leading '$'. This Address will be checked first before the command is being
  94. executed. If the check fails, you'll get an error message or a warning or
  95. a prompt, depending on what went wrong. Names are always the last parameter
  96. to enter. This may seem strange, but it is the simplest way to get rid of
  97. enbedded blanks.
  98.  
  99. Time <seconds>
  100. Set time between updates. Minimum is 1 second, maximum is 255, default is 5
  101. seconds.
  102. Example: Time 1
  103.  
  104. Taskpri <priority> [processnumber] <taskname>
  105. Change the priority of a task. Values may range from -127 to 127, better
  106. use values between -5 and 5.
  107. Example: Taskpri 5 New Cli
  108.  
  109. Mypri <priority>
  110. Shortcut for "Taskpri Xoper <priority>"
  111. Example: Mypri 6
  112.  
  113. Pri <priority> <nodename>
  114. Change the priority of any other node. This commad does not work for Tasks.
  115. If the specified node has been found, the entire list the node belongs to
  116. will be resorted.
  117. Example: Pri 1 Chip Memory        (try to allocate memory in CHIP first)
  118.  
  119. Break [processnumber] <taskname>
  120. Set break signals. Useful for tasks running in background or from Workbench.
  121. Example: Break 3 New CLI
  122.  
  123. Hunks [processnumber] <processname>
  124. Show location, BCPL-Pointers and length of memory blocks the process uses.
  125. Example: Hunks RAM
  126.  
  127. Snoop [processnumber] <taskname>
  128. Track memory allocation/deallocation of a task. Press break (CTRL-C) to
  129. stop. List includes: action (alloc/free), memory requirents (CHIP/ FAST/
  130. PUBLIC etc), memory size, memory location (start, end) and the address from
  131. where AllocMem() was called.
  132.  
  133. Files
  134. List lock, access, size and name of open files.
  135.  
  136. Locks
  137. List any lock.
  138. BUG: Trying to lock the Volume "RAM Disk" crashes the machine sometimes. If
  139. a Volume "RAM Disk" is found it will be replaced by the devicename "RAM:"
  140. (this has been fixed on WB 1.3). Make sure you don't have a disk labeled
  141. "RAM Disk" or you'll never see its locks:-)
  142.  
  143. Currentdir
  144. List current directory settings of all processes.
  145.  
  146. Devices
  147. List name,heads,sectors,tracks,startup-buffers and handler-process of every
  148. DOS-device.
  149.  
  150. Capture
  151. Show vectors controling the reset, i.e. CoolCapture, ColdCapture and
  152. WarmCapture pointers, KickMem allocations. Useful when searching
  153. for Viruses, but remember that the RAD: device in 1.3 uses the KickMem
  154. pointer to recover from a reset.
  155.  
  156. ClrCool
  157. ClrCold
  158. ClrWarm
  159. Clear one of those pointers.
  160.  
  161. Lockdrive <drivename:>
  162. Prevent DOS, Workbench and Disk-Validator from cluttering on the drive.
  163. This command isn't very useful, but I needed it myself. Please note that
  164. the drivename is case sensitive and has to end with a ':'.
  165.  
  166. Freedrive <drivename:>
  167. Re-enable a drive.
  168.  
  169. Windows
  170. List address and title of all windows.
  171.  
  172. Screens
  173. List address and title of screens.
  174.  
  175. Fonts
  176. List address,height,width,type,fist character and last character of all
  177. loaded fonts.
  178.  
  179. Windowfonts
  180. List Windows and associated fonts.
  181.  
  182. Freeze [processnumber] <taskname>
  183. Halt a Task. The task should be READY or WAITING. Frozen tasks are queued in
  184. a new list called FREEZED. When you leave Xoper, halted Task will be
  185. released.
  186. Example: Freeze Killer Graphics Task
  187.  
  188. Warm [processnum] <taskname>
  189. Restart a halted Task. Task must be FREEZED.
  190. Example: Warm Killer Graphics Task
  191.  
  192. Info <librarynode | devicenode>
  193. Show additional information stored in the lib_IdString field.
  194. Example: Info arp.library
  195.  
  196. Openlib <libraryname>
  197. Open a library. This is useful if you don't want a specified library being
  198. 'flushed' out.
  199. Example: Openlibrary arp.library
  200.  
  201. Clear [longword]
  202. Fill unused memory chunks with pattern, default is 0. Handy for debuggers.
  203. Example: Clear $66726565
  204.  
  205. Flush
  206. Clean up memory, flush unused libraries, devices and fonts.
  207.  
  208. Lastalert
  209. Show last Guru Meditation code or rubbish.
  210.  
  211. Usage
  212. Toggle CPUSE field on the task display between usage relative to all
  213. possible dispatches and usage relative to actually dispatched tasks.
  214. Ahem...not very clear I think. Well, let me try again...
  215. If you add all CPUSE fields together you get 100 % (more or less 1%). After
  216. entering "Usage" adding the fields together will give you the same value as
  217. shown in the 'CPU Activity field'. (I HATE having to write docs)
  218.  
  219. Taskports
  220. Disable / enable a listing of taskports if ports are displayed.
  221.  
  222. More
  223. Stop displaying "<MORE>" and "<RETURN>" if output exceeds window.
  224.  
  225. Quit or just Q
  226. Exit Xoper. If Xoper was started with '-b' or if 'Hold' was specified it
  227. will stay in background waiting for LeftAmiga-RightAmiga-X.
  228.  
  229. Hold
  230. Exit Xoper but install a key-handler and stay in background. Window
  231. settings and display commands are saved.
  232.  
  233. Exit
  234. Clean up and quit.
  235.  
  236. !!!! WARNING: The next few commands are dangerous and 'dirty' !!!!!
  237. !!!!!!!!!!!! don't use them if not strictly necessary !!!!!!!!!!!!!
  238.  
  239. Cancel [processnumber] <taskname>
  240. Cancel a task or a process. If the task has been called from CLI, the Task
  241. itself and the CLI will be killed. Hunks, Windows, Screens  and the
  242. teminal-window will be freed. Simple tasks are just RemTask()'ed. If it is
  243. not a CLI Task you'll be asked if it is a Workbench task, if the answer is
  244. 'Yes' unloading will be done by the Workbench. If not, you will be prompted
  245. if Xoper should unload the code. Enter 'No' if you don't know how the task
  246. has been started.
  247.  
  248. Closewindow <title>
  249. Closes a Window. Please, use it only if the corresponding Task has been
  250. 'Cancel'ed. Use the Window-Structure address if the window has no name.
  251.  
  252. Closescreen <title>
  253. same as above, but for screens.
  254.  
  255. Unlock <lock (BPTR)>
  256. Unlock a file.
  257.  
  258. Closelib <libraryname>
  259. This is exactly the same as CloseLibrary().
  260.  
  261. CD [processnumber] <processname>
  262. Change the current directory of a process. You are prompted if the old
  263. directory lock should be unlocked.
  264.  
  265. Signal <mask> [processnumber] <taskname>
  266. Set any task-signal. Mask is a hexadecimal value with or w/o leading '$'.
  267. See task's SIGWAIT field for sensible values. Tasks normaly do not wait for
  268. signals only, but for messages, that's why this command may not have the
  269. desired effect, but it is quite useful for tasks hanging around and waiting
  270. for events that may never happen. Warning: Using Signal without any
  271. knowledge about what you are going to signal may cause a system-crash!
  272. Example: Signal 10000000 PopCLI III
  273.  
  274. ----------------------------------------------------------------------------
  275.  
  276. Please send flames, bug reports and especially a list of features you would
  277. like to have included in the next version to
  278.  
  279.  Werner Gunther
  280.  Wingertspfad 12
  281.  D 6900 Heidelberg
  282.  (Germany)
  283.  
  284. or to my EMAIL address for a fast response:
  285.  
  286.  G35@DHDURZ1.BITNET
  287.  
  288.  
  289.